SGSetSoundInputParameters(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Sound Channels

SGSetSoundInputParameters
The SGSetSoundInputParameters function allows you to set some parameters that relate to sound recording.
pascal ComponentResult SGSetSoundInputParameters (SGChannel c, 
                                          short sampleSize,
                                          short numChannels,
                                          OSType compressionType);
c
Identifies the channel for this operation. You provide your
connection identifier. You connect to a channel component by calling the SGNewChannel or SGNewChannelFromComponent function, discussed on page 5-29 and page 5-30, respectively.
sampleSize

Specifies the number of bits in each sound sample. Set this field to 8 for 8-bit sound; set it to 16 for 16-bit sound.
numChannels

Indicates the number of sound channels used by the sound sample. Set this field to 1 for monaural sounds; set it to 2 for stereo sounds.
compressionType

Describes the format of the sound data. The following values are supported:
'raw '
Sound samples are uncompressed, in offset-binary format (that is, sample data values range from 0 to 255).
'MAC3'
Sound samples have been compressed by the Sound Manager at a ratio of 3:1.
'MAC6'
Sound samples have been compressed by the Sound Manager at a ratio of 6:1.

DESCRIPTION
You may use the SGSetSoundInputParameters function to control many parameters relating to sound recording. All of the sound parameters support two special values. If you set any of these parameters to 0, the sequence grabber does not change the current value of that parameter. If you set any of them to -1, the sequence grabber returns that parameter to its default value.
If you select a parameter value that the sound device cannot support, the sequence grabber returns an appropriate Sound Manager result code.

RESULT CODES
Sound Manager errors